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SECTION I 


TERMINAL/BATCH INTERFACE DESCRIPTION 


The Terminal/Batch Interface Facility of the Honeywell Series 6000 
Time-Sharing Systemlconsists of an interrelated set of time-sharing 
subsystems and batch programming facilities. These combine to provide 
the time-sharing terminal user with full batch programming capabilities. 
This facility allows the user to submit a batch program, debug the 
program, and inspect the program output; all from a remote terminal. 
This interface also facilitates direct, interactive communication 
between the user's batch program and his (or another) terminal. 


The elements making up this facility fall into three categories: 


1. The CARDIN time-sharing subsystem, which allows the actual 
submission of batch jobs to the System Input program and 
integrates the other elements into a functional whole. 


2. Supporting subsystems, SCAN, JOUT, and FDUMP, which allow batch 
output scanning, batch output manipulation, and file dumping 
and modification (in octal), respectively. (The latter is 
primarily a debugging tool.) 


3. Two batch dimension features, Conversational Debug Routine 
(RBUG) and Conversational-I/O extensions to the File and 
Record Control logical record processing routines, are for 
inclusion in the batch program itself. These allow direct 
access connection between the program and the remote terminal, 
where desired. 


1lall references to Series 6000 also apply to Series 600 unless otherwise 
stated. 
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SECTION II 


CARDIN SUBSYSTEM 


CARDIN FUNCTION 


CARDIN is the component subsystem of the Series 6000 Time-Sharing 
System, which makes available to the time-sharing user the wider 
facilities of batch processing. It permits a remote terminal user to 
perform such functions as developing and checking out a batch program 


written in macro assembler (GMAP) language. CARDIN also provides a 
convenient means of maintaining and initiating application programs such 
as APT, Linear Programming, and data reduction programs. Almost any 


other situation where a time-sharing terminal user needs access to batch 
facilities can be accommodated by CARDIN. 


Essentially, CARDIN allows the user to create at his terminal a card 
image input file, submit it for batch processing, and receive notice of 
the result (successful termination, abort, etc.). The user then may have 
the job output printed at the central site or a remote batch facility, 
or inspect the output file conversationally by selective listing at the 
terminal. (Refer to SCAN Subsystem, Section III.) 


The TALK option of CARDIN allows a terminal user to talk to a= program 
running in the central computer system. This option places the user's 
terminal in direct access, conversational connection with any program 
that was submitted through CARDIN and that contains remote terminal 
input/output. The TALK option facilitates the use of the Conversational 
Debug (RBUG) routine by allowing interactive, execution time debugging 
from the user's terminal. 


Permission from the master user must exist in the Time-Sharing System 
before a specific user can employ CARDIN. If master user's permission 
has been granted for use of TALK disposition, use of all CARDIN 
functions is implied. 


CARDIN OPERATION 


As in Time-Sharing BASIC, the file-building facility provided by CARDIN 
requires line numbers. BASIC-like editing of keyboard input and updating 
of the current file is performed. The line numbers can be either 
stripped automatically from each line or moved to the card image 
sequence number field at the time the job input file is passed to the 
batch world. 


2-1 BR9Q 


In converting the user's time-sharing source ASCII file to a BCD card 
image job input file, one line of terminal input represents one _ card. 
The user must include in his source file all cards that would normally 
be required in the batch environment except the $ SNUMB, $ USERID, and 
***kEOF cards. A $ USERID card is generated by CARDIN when required for a 
permanent file, so that the user need not reveal his log-on password. 
This card does not show on a LIST request for the file. However, the 
user may supply his own $ USERID card if he wishes, and the System Input 
program uses this rather than the one supplied by CARDIN. 


Tab characters may be used when building the file in order to avoid 
keying in the blanks required by a fixed-field language such as _ GMAP. 
The tab character can be assigned a sequence of character-position 
values--for example, tab,8,16,32,73. Each successive occurrence of the 
tab character within a line causes the next unused value in the sequence 
to be assigned to it. More than one tab character may be specified, 
each with its own sequence of tab settings. 


ASCII-to-BCD conversion and reformatting of a file is obtained at _ the 
following times: 


1. When the user gives a RUN command, causing conversion onto a 
scratch file and passage of the file to the System Input 
program for processing. 


2. When the user gives an ASCBCD command, causing conversion onto 
a permanent file only. 


In neither case is the original ASCII file itself affected. 


The information needed by CARDIN for converting and reformatting a_ file 
may be supplied by the user in either of two ways: 


e The tab characters, settings, and line number disposition may be 
Supplied in response to questions asked by CARDIN. 

e To minimize the user/subsystem interface, the same information 
may be supplied on the first line of the file itself. 


The user may also convert a system format Binary Coded Decimal (BCD) 
file to a time-sharing ASCII file by means of the BCDASC command. 
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The general operation of the subsystem is as follows: 


ds 


The terminal user builds his file under CARDIN or calls for an 
OLD file previously prepared under CARDIN or other time-sharing 
subsystem. If line numbered, the file can then be corrected, 
updated, resequenced, etc., using standard time-sharing 
commands. The user can request that his current file be run, 
using RUN or RUN filedescr. 


When the user requests a run of his current file, he is given 
the SNUMB sequence number of his batch run. He is then asked a 
series of questions concerning the format of his file and _ the 
desired disposition of the job, if this information did not 
appear on the first line of the file. 


When the question/answer sequence is completed, the user's 
time-sharing source file (which is in ASCII) is converted to 
BCD and put in the desired card format. It is then passed to 
the System Input program for processing. 


Following a batch job termination message, the user may inspect 
his output by giving the command SCAN filename, where filename 
is the name of a permanent. file upon which the batch-job output 
has been placed. This placement is achieved by appropriate use 
of the $ PRMFL control card. | 


The output scanning facilities of the SCAN subsystem are 
available through use of the SCAN command. 


Instead of having the file converted and processed, the user 
can have it converted and then printed out at the terminal in 
the requested job input format by means of the PRINT command. 
This facilitates visual inspection before actually passing the 
file to the System Input program (with a subsequent RUN 
command). The PRINT command initiates a question/answer 
sequence Similar to that for the RUN command. 


CARDIN DETAILED OPERATION 


CARDIN Command Language 


The CARDIN commands which follow are not all unique to CARDIN, but’ some 
have special meaning. 


1/73 


2-3 BR9IIB 


1. RUN 


Convert and pass the current file to batch processing, following 
the question/answer sequence that is initiated by this command if 
the file does not contain first line reformatting information. 
The SNUMB of the job is printed. 


2. RUN filedescr 


Convert and pass the file saved under filedescr to the batch 
world for processing, following the question/answer sequence that 
is initiated by this command if the file does not contain first 
line reformatting information. The current file, if one exists, 
is not disturbed. Filedescr is simply the file name for a quick 
access permanent file; for other permanent files it is the file 
description. The SNUMB of the job is printed. 


@ PRINT 
1. PRINT 


Reformat the contents of the current file and print it at the 
terminal, following the question/answer sequence that is 
initiated by the command if the file does not contain first line 
reformatting information. 


2. PRINT filedescr 1; filedescr 2;...;filedescr n 


Reformat the contents of the file saved under filedescr and print 
it at the terminal, following the question/answer sequence that 
is initiated by this command if the file does not contain first 
line reformatting information. The current file, if one exists, 
is not disturbed. (See definition of filedescr under RUN 
command.) 


e JDAC 


JDAC name 


Allows time-sharing terminal user to establish connection with a GRTS 
(General Remote Terminal Supervisor) Direct Access (DAC) program, 
where name is the program's remote inquiry name already supplied to 
GCOS via a MME GEROUT. If name is not supplied with the JDA™ request, 
the system returns a NAME? query. 
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When the direct access program terminates, the system returns to the 
command entry (build mode) level within CARDIN. 

JSTS 

JSTS snumb | (Job Status) 


Causes the current batch processing status of the job specified by 
snumb to be printed at the terminal in plain text. 


With an OUTPUT WAITING cor an OUTPUT COMPLETE message, JSTS will 
attempt to give termination status. For example: 

*JISTS 0003T 

0003T OUTPUT COMPLETE 

IF LAST JOB SUBMITTED, STATUS WAS: 

FO - MEMORY ADDRESS FAULT 
This termination status information is available only for the most 
recent job submitted by the user during the current (log-on session. 
If the job referred to by snumb is not the last job submitted, the 
termination status does not apply to it, but to the last job 
submitted. 
JABT 
JABT snumb (Job Abort) 
Causes the batch job specified by snumb to be aborted, with an abort 


code assigned. Only jobs containing a valid $ USERID control card for 
the requesting user will be aborted. 


ASCBCD 
ASCBCD ascfil; bcdfil (ASCII-to-BCD) 
ASCBCD 


INPUT FILES ascfil;bcdfil 


If the response to "INPUT FILES" is null (carriage return), control 
is returned to the level from which the command was issued. The ASCII 
time-sharing file specified by ascfil is converted to ae standard 
system format BCD file on the permanent file specified by bcdfil. 
This follows the question/answer sequence that is initiated by this 
command if the ASCII file does not contain first line reformatting 
information. Both ascfil and bcdfil may be simply a file name or a 
full file description, as required. (See definition of filedesc under 
RUN command.) The ascfil field may specify the current file by an 
asterisk. : 


1/73 2-5 BR99B 


ASCASC filedescr 1; filedescr 2 


This command, issued under Series 6000 FORTRAN and other time-sharing 
language systems, causes the translation of a time-sharing format 
ASCII file to a standard system format ASCII file or vice versa. In 
both translations, file 1 is converted to the format required in file 
2. If file 1 is in time-sharing ASCII format (logical record type 5), 
the file is read and converted to the word-oriented standard system 
ASCII format for file 2. File 2 may then be used as input data for 
the language system. If file 1 is in standard system ASCII format 
(logical record type 6), the file is read and converted to the 
character-oriented time-sharing ASCII format for file 2. File 2 may 
then be listed at a terminal. 
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BCDASC 


BCDASC bcdfil; ascfil (BCD-—to-ASCIT) 


The standard system format BCD permanent file specified by bcdfil is 
converted to an ASCII time-sharing file on the predefined permanent 
file specified by ascfil. This follows the question/answer sequence 
that is initiated by this command. Both bcdfil and ascfil may be 
simply a file name or a full file description, as required. (See 
definition of filedescr under RUN Command.) The ascfil field may 
specify the current file by an asterisk. 


BPUNCH and BPRINT 
BPUNCH ascfil (Batch Punch) 


BPRINT ascfil (Batch Print) 


The contents of the ASCII time-sharing file specified by ascfil is 
converted to BCD and is punched or printed, respectively, at the 
central computer site. This follows the question/answer sequence that 
is initiated by these commands, if the file does not contain first 
line reformatting information. These commands allow the user to 
create card backup for his time-sharing files or to list long files 
on a high speed printer. The ascfil field may be simply a file name 
or a full file description, as required. (See definition of filedescr 


under RUN Command. ) The ascfil field may specify the current file 


by an asterisk. 


Since a batch dimension bulk media conversion (BMC) job is implied by 
these commands, batch $ IDENT card information is requested. 


FDUMP 


Permits inspection and maintenance of permanent files at remote 
terminals. Refer to the description of the FDUMP subsystem in Section 
IV. 


SCAN 


Allows the scanning of batch output stored on a permanent file. Refer 
to the description of the SCAN subsystem in Section III. 
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ae 


e JOUT 


JOUT snumb 


Permits manipulating from a time-sharing terminal the output of 
certain types of batch jobs. Refer to the description of the JOUT 
subsystem in Section VII. 


RUN or PRINT Question/Answer Sequence 


If the file to be converted does not contain first line reformatting 
information immediately following the RUN or PRINT command, a fixed 
sequence of questions is asked by the system concerning the format and 
desired disposition of the file. 


Response to CARD FORMAT,..... m4 


The user responds to the first part of the question, CARD FORMAT, 
DISPOSITION? with ASIS, STRZP, MOVE, or NORM. (The short form defined in 
parentheses may also be used.) 


ASIS (A) 


The user wants the file passed to batch just as it exists. In this 
case, each line of terminal input is converted to BCD and put in 
card format. The content of the first character position of the 
terminal line goes in the first column of the card, unless it is a 
tab character. Use of ASIS implies either that the file does not 
contain initial line numbers or that the user desires them to 
appear in this batch input file. 


STRIP (S) 


This specifies that the user has employed line numbers’ when 
preparing his file and wants the line number stripped from each 
line before converting to cara format. When this option is’ used, 
the first nonnumeric character of a terminal line, if not a tab, 


goes in column 1 of the card. (Line numbers in the source file are 
unaffected.) 


MOVE (M) 


This option states that the user has employed line numbers’ when 
preparing his file and wants the line numbers moved to the sequence 
field (columns 73-80) of the card. When this option is used, the 
first nonnumeric character of a terminal line, if not a tab, goes 
in column 1 of the card. 
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NORM (N) 


This option implies the MOVE option and specifies that the normal 
tab character (the colon) and tab settings (8,16,32,73) have been 
employed in building the file. Following a response of NORM, the 
TAB CHARACTER AND SETTINGS? query is omitted. 


The NORM format may also be used to define a character other than 

the colon to be used as a tab and may permit multicard lines by 

means of a character used to indicate the end of a card. These 

options are indicated in a parentheses enclosed field following 

eae Either character may be omitted, as shown in the examples 
elow. 


Examples: 
NORM (;,/) 
The semicolon is the tab character and end-of-card is 


indicated by /. That is, a line such as the following has been 
employed in the file: 


70;LDA;A/;STA;B/;TRA;:C 
NORM(,;) 


The colon is the tab character by default, and the semicolon 
is the end-of-card character. 


NORM (;) 
The semicolon is the tab character; no end-of-card character 
is given. 


Note: A line number is from one to eight numeric characters immediately 
followed by a nonnumeric character (including blank), the numerics being 
the first nonblank characters in the line: 
%...Bnnnnnnnnxcc.....c 
Where: B...B - Optional initial blank. 
nnnnnnnn - Numeric characters. 


x Nonnumeric character, 


CC.ww.e--C - Any characters. 


For STRIP, MOVE, and NORM, if the user wants a numeric in column 1 of 
the card image and line numbers exist in the source file, a pound sign 
(#) character immediately following the line number causes the character 
following it to go into column 1. 


For example, 220#123 would result, upon a MOVE conversion, in the card 
numbered 220 having 123 in columns 1, 2, and 3. If the user desires that 
a pound sign go into column 1 of the card image, two pound signs 
following the line number will achieve that effect. For example, 220## 
would result, upon a MOVE conversion, in the card numbered 220 having a 
pound sign in column l. 
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Response to DISPOSITION? 


Having entered a response to the CARD FORMAT portion of this question, 
the user answers the DISPOSITION portion with one of the following 
entries (note that each is preceded by a comma). 


If, 


eee ,WAIT -- Wait for job termination. 
$-é%ep ) Alak -- Enter conversational mode. (Use may be 
restricted by master user. See 


Giscussion of TALK.) 


e ee ,URGC (xx) -- Assign specified initial urgency to this 
job. 
“cep OUL -- Save all implied files for examination 


by JOUT subsystem. 


Sap ROUT CX) -- Direct output to station xx. Only one 
ROUT entry is permitted. 


instead of entering a reply to DISPOSITION, the user follows his 


card format entry with a carriage return, the job is initiated, and the 
system returns to build mode for further CARDIN command entries. 


1/73 


WAIT (W) 


This response indicates that the user desires to wait at this point 
for a status indication sent upon completion of the job in the 
batch environment. Normal termination is indicated by the message 


NORMAL TERMINATION 


Any abnormal termination is indicated by an appropriate plain text 


message. (See abort/delete messages in Comprehensive Operating 
Supervisor reference manual.) 


Following the termination message, the system returns to build mode 
for further CARDIN command entries. 


2-9 BRIOB 


1/73 


TALK (T) 


This response implies that the batch job includes execution of a 
program containing conversational (direct access) input/output -- 
either user-implemented direct access I/O or, for example, the RBUG 
routine (see Section V). Following the actual submission of the job 
by CARDIN, the user's terminal is placed in direct access 
connection with the submitted program (by SNUMB). When the job 
terminates, the user receives a normal or abnormal termination 
message and returns to build mode, as with WAIT. 


Permission from the master user must exist in the Time-Sharing 
System before a specific user can employ the TALK disposition. 
(Granting of permission to use TALK implies permission to use all 
CARDIN functions.) 


URGC (xx) (U) 


This response may be used only when the RUN command has_ been 
previously entered. The response indicates that the user wants’ to 
assign initial urgency xx to the job. The assigned urgency must not 
be greater than the maximum allowed, or the system will reply with 
the message ILLEGAL URGENCY after the next carriage return and 
follow it with the CARD FORMAT, DISPOSITION? question. 


If xx is not specified, maximum allowable urgency is automatically 
assigned. 


This disposition response may be specified by itself or along with 
JOUT and/or WAIT or TALK. 


JOUT (J) 


This response may be used only when the RUN command has_ been 
previously entered. The response requests that all implied files be 
saved so that they may be examined using the JOUT subsystem. 


This disposition response may be specified by itself or along with 
URGC and/or WAIT or TALK. 


2-10 BR99B 


ee ge 


1/73 


ROUT (xx) (R) 


This response may be used only when the RUN command has been 
previously entered. The response indicates that the user 
wishes the implied files generated by the program execution to 
be directed to the specified two character remote station. 
This response to DISPOSITION may be specified by itself or 
along with any other disposition except JOUT. Only one ROUT 
entry permitted. 
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Following are examples of responses to the CARD FORMAT, DISPOSITION? 
question. Note these points: 


1. A response must be entered for CARD FORMAT, and this response 
must be the first item. 


2. The responses may be represented by their initial letters. 
3. The DISPOSITION responses may be in any order. 


4, The responses are separated by commas, with no embedded blanks. 


Examples: 


MOVE 

ROUT (BC) 

MOVE, TALK 

R(AD) (Same as as ROUT (AD) ) 
M,T (same as MOVE, TALK) 
NORM(;,/),W (W = WAIT) 

N(;,/) ,URGC(35),d (N = NORM, J = JOUT) 
N,U(35), 35,7 (Same as NORM, URGC(35) ,JOUT, TALK) 
A,J (same as ASIS,JOUT) 
S,U,JOUT (same as STRIP,URGC,JOUT) 
A,R(DD) (same as ASIS,ROUT(DD) ) 


Response to TAB CHARACTERS AND SETTINGS? 


This guestion is asked only if NORM has not been specified in response 
to CARD FORMAT, DISPOSITION? 


When the file is being prepared, the user can employ tab characters’ to 
format his input instead of the required blanks. Any character except 
the pound sign (#) can be used to indicate a tab, or the regular tab key 
can be used. Delimiters used for tab should be unique. When responding 
to the above question, the user may specify a tab character and up to 20 
tab settings. All fields are separated by commas. For example, if the 
user employed an ampersand (&) as a tab character and desired successive 
tab values of 8,16, and 40 in his card-image input file, he would 
respond with &,8,16,40. 
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If the user employed the standard character and settings (3707165 392,73).; 
he may respond Simply with NORM or N. 


If the user did not use any tabs in preparing his input, he would Simply 
respond to the above question with a Carriage return. 


The user may employ multiple tab characters (tab entries Separated by a 
Semicolon) in his file--one for language statements and another for 
control cards, for example. 


&,8,16;+,12,32,40 
where the tab characters are & and +. 


A maximum of seven different tab characters and a total of 35 individual 
tab settings can be specified within the limits of one 80-character 
input line of the file. 


ASCBCD Question/Answer Sequence 


The questions LABELS? and, conditionally, TAB CHARACTERS AND SETTINGS? 
are asked when the ASCBCD command is given, if the file ascfil does not 
contain first line reformatting information. The responses are for the 
most part identical with those given in the RUN and PRINT 
question/answer sequence. Where the responses are identical, the 
explanation of them is not repeated, as the meaning is the same. 


Response to LABELS? 


@ MOVE 
@e STRIP 
@ ASIS 
e@ NORM 
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@ abcde(i,j) i abcde(i,j)o; ...7 abcde(i,j)y 


This option implies that the line numbers in the file are to be 
moved to the BCD label field (columns 73-80) and that the 
alphanumeric prefix abcde; is to be inserted -- left justified 
-- in the label field as specified by the line numbers (1,5)43 


abcde; represents any alphanumeric prefix, to 
a maximum of five characters 

Lg represents the initial line number 

Jy represents the final line number to 


which abcde; is to be prefixed 


The (1,3) field is mandatory; the conventions on its use are as 
follows: 

(gs) G9) 
(0,3) 


(1,99...9) 


~~ 

= 

J. 

— 
1 


~-_ 

}- 
~ 

— 
| 


~~ Multiple sets of prefix specifications may be given, semicolon 
a i e e 
separated, as shown in the general form above. If an interval of 
line numbers is found in the file that has not been specified by 
the user, only the line number will appear in the label field. 


The prefix will overlay leading significant digits of the line 
number, if the line number becomes too large to be accommodated, 


Response to TAB CHARACTERS AND SETTINGS? 


If the response to LABELS? was not NORM, the question TAB CHARACTERS AND 
SETTINGS? is asked. The possible responses are: 


@® carriage return (null response) -- Indicates that no tab 
Characters are employed in the file. 


@e t,/S1/S2,--,Sn ~~ Indicates a single set of tab character (t) and 


settings (sn) have been used, as in the RUN or PRINT 
responses. The value of s, must be less than 81. 
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@ tab-set);tab-set9;...;tab-setyn -- Indicates that multiple sets 
of tab characters and settings have been used in the 
file -- as in the RUN or PRINT responses--where 
tab-set has the same form as_ the Single-set 
specification shown above. 


A maximum of seven different tab characters and a total of 35 individual 
tab settings can be specified within the limits of one 80-character 
input line of the file. 


BCDASC Question/Answer Sequence 


The questions LINE NUMBERS? and TAB CHARACTER AND SETTINGS? are asked 
when the BCDASC command is given. The first question requests 
information concerning what line numbers, if any, are desired in the 
converted ASCII file (ascfil). The second question requests information 
concerning a single tab character. 


The responses to LINE NUMBERS are: 


@® carriage return (null response) -- Do not create line numbers 
for the ASCII file. 


@ MOVE -= Use the sequence-number digits of the label field in 
the BCD file as line numbers for the ASCII file. 


e AUTO == Create line numbers for the ASCII file, starting 
with 0010 and incrementing by 10. 


e AUTO n,m -- Create line numbers for the ASCII file, starting 
—. with n and incrementing by m. If either n or m is 
null (AUTO n, or AUTO ,m), the missing variable will 

have the standard value shown under AUTO, above. 


@ ASIS,n -- Convert from BCD to ASCII n columns of the BCD 
record. 


Response to TAB CHARACTER AND SETTINGS? 


The response is similar to the response to the same question under 
ASCBCD. However, only one tab character and its settings may be entered. 
Blanks in the ASCII file will be eliminated and the tab character 
inserted as directed in the response. Thus, the created ASCII file will 
appear as though it was entered from a terminal with the use of tab 
characters. 
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BPUNCH or BPRINT Question/Answer sequence 


Both the BPUNCH and BPRINT commands ask the same series of questions: 


$ IDENT? 
LABELS ? 


TAB CHARACTERS AND SETTINGS? 


The responses to the first two questions are the same as those for the 
ASCBCD command. The response to $ IDENT is identical in form and content 
to the variable field information that would be required on the S$ IDENT 
control card for a comparable batch job. (A batch BMC job is actually 
initiated). 


First Line Reformatting Information in the File 


To minimize the subsystem/user interface involved in the use of the RUN, 
PRINT, and ASCBCD commands, the required reformatting and disposition 
information may be contained within the file to be converted as its 
first line and identified by the special marker characters ##. If this 
information exists in the file submitted, the normal question/answer 
sequence is bypassed. 


The general format of the first line reformatting information is as 
follows: 


line-number##first-response second-response 


Wheres: 
line-number - Optional line number. 


first-response - An appropriate full response to CARD 
FORMAT, DISPOSITION? in the case of RUN; 
to CARD FORMAT? in the case of PRINT; or 
to LABELS? in the case of ASCBCD. 


second-response - An appropriate response to TAB CHARACTER 
AND SETTINGS? -- if required -- in the 


case of all three commands, separated 


from the preceding first-response by one 
blank. 
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The form of the information represented by first-response and 
Ssecond-response is precisely that which would be required by the 
question/answer sequence of the respective commands. 


An example of first line control information for the RUN command is’ as 
follows: 


10##MOVE,WAIT ;,8,16,32 


Note that the semicolon following the single blank specifies the tab 
character and is not a separator. 


Another example: 
10 ##NORM 


Note that the second-response portion is null in this example because of 
the use of NORM as the first-response. 


S$ SELECTA Card Option 


With $ SELECTA cards the user may merge two or more time-sharing input 
files into one batch file. The select function is initiated when a 
S$ SELECTA card is detected in the input stream. The format is: 


1 8 16 
S$ SELECTA filedescr 


Where: filedescr applies to the file selected for merging with the 
current file. 


Upon encountering this card, CARDIN stops processing input from the 
current file and begins processing the selected file. When an EOF is 
encountered on the selected file, processing reverts to the previous 
file. The $ SELECTA card is deleted from the input stream by CARDIN and 
does not become part of the batch input. 
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Restrictions on the $ SELECTA card option are as follows: 


e Nesting of a select activity within another select activity is 
permitted to a depth of 10. 


e The contents of the selected file must be in time-sharing 
format. 


e No test will be made for first line reformatting information on 
selected files. 


e A S$ ENDJOB card detected in a selected file will be bypassed. 


The following terminal printout is an example of the use of the CARDIN 
subsystem, utilizing the LIST and PRINT control commands and the SCAN 
subsystem. The text enclosed within brackets is not part of the printout 
but has been added to explain salient features. 
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SYSTEM ? CARDIN 
OLD OR NEW-OLD PASSRC 


READY 
*LIST@--------------- List the input file. 


010$S; IDENT; VXA,JANEDOE 

015S s;USERID; JANEDOES PASSWORD 

020$;NOLIB 

030$ ;OPTION ; NOSETU, SAVE/PX , NOGO 

040S ;LOWLOAD 

050$S;ENTRY;BEGIN 

060S ;GMAP;NDECK 

070;TTL;SUBSYSTEM TO LIST AVAILABLE FILE TABLE 

080;LODM;.G3TSS 

090;.SSDRL 

095;BSS;36;REQUIRED RESERVE SPACE FOR TS 

100 ;SYMDEF ; BEGIN 

LIOBEGIN;DRL;PASAFT;READ THE AFT 

120; ZERO;LOCA,0 

130;LXL2;LOCA;GET FILE COUNT 

140;TZE;END;NO FILES... 

150 ;EAX1 ;LOCA+1 

L60AGAIN;LDA1;0,1;PUT NAME IN LINE 

170 ;STAQ;NAME 

180;LDAQ;TAL1;REFRESH THE TALLIES, 

190;STAQ;TEMP 

200;DRL;KOUT;WRITE THE FILENAME. 

210 ;ZERO;TEMP,CHAR 

220;EAX1;2,1; INCREMENT LOCA POINTER 

230;EAX2;-1,2;DECREMENT COUNT 

240;TNZ;AGAIN;GET NEXT NAME 

250END; DRL; RETURN 

260; REM 

270LOCA;BSS;25;AFT BUFFER 

280TAL1 ;TALLY;TEMP+1,1;OUTPUT TALLY 

290;TALLYB; NAME, 8 

300CHAR;OCT;015012177177;CR,LF,NULL ,NULL 

3LONAME;ASCII;2, 

320;END 
Place program in 
system loadable format 

330$;PRMFL;H* ,R/W,R,JANEDOE/PASFIL@ Jon permanent file 
PASFIL. 


Place system output 
file on permanent file 


340$;PRMFL; P*,R/W,L,JANEDOE/PASLST@-|PASLST for use by 
SCAN. 


350$ ;ENDJOB 
READY 
* 


Indicates BUILD 
mode. 
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----- | Print the file in its extended format.| 


VXA , JANEDOE 
JANEDOESPASSWORD 

NOSETU , SAVE/PX , NOGO 

BEGIN 

NDECK 

SUBSYSTEM TO LIST AVAILABLE FILE TABLE 
.G3TSS 

36 REQUIRED RESERVE SPACE FOR TS 
BEGIN 

PASAFT READ THE AFT 

LOCA, 0 

LOCA GET FILE COUNT 

END NO FILES... 

LOCA+1 

0,1 PUT NAME IN LINE 

NAME 

TALI REFRESH THE TALLIES. 
TEMP 

KOUT WRITE THE FILENAME. 
TEMP ,CHAR 

2,1 INCREMENT LOCA POINTER 
-1,2 DECREMENT COUNT 

AGAIN GET NEXT NAME 

RETURN 

50 AFT BUFFER 

TEMP+1,1 OUTPUT TALLY 

NAME , 8 

015012177177 CR,LF,NULL,NULL 

2, 


H* , R/W,R, JANEDOE/PASFIL 
P* ,R/W,L,JANEDOE/PASLST 


*PRINT@-- 

CARD FORMAT ? 
MOVE 

TAB CHARACTER AND SETTINGS? 
$4707 16,32 
08/02/68 12.92 
010 $ IDENT 
015 S$ USERID 
020 $ NOLIB 
030 $ OPTION 
040 $ LOWLOAD 
050 $ ENTRY 
060 $ GMAP 
070 Te; 
080 LODM 
090 »SSDRL 
095 BSS 
100 SYMDEF 
110 BEGIN DRL 
120 ZERO 
130 LXE 2 
140 TZE 
150 EAX1 
160 AGAIN LDAI1 
170 STAQ 
180 LDAQ 
190 STAQ 
200 DRL 
210 ZERO 
220 EAX1 
230 EAX2 
240 TNZ 
250 END DRL 
260 REM 
270 LOCA OBSS 
280 TAL1 ETALLY 
290 TALLYB 
300 CHAR OCT 
310 WAME ASCII 
320 END 
330 $ PRMFL 
340 $ PRMFL 
350 $ ENDJOB 


* 
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*RUN@---|Prepare to send input file to batch. 
SNUMB # 0122T@--- |SNUMB Assigned to this job. 


CARD FORMAT,DISPOSITION ? 


M,W@--- |CARDIN options MOVE and WAIT 


TAB CHARACTER AND SETTINGS? 


*SCAN PASLST@------- 


FORM? GMAP@+--------- 
006 ERRORS 

EDIT?Y 

?FLAG@------------- | 


M 2 LODM .G3TSS 00000080 #0013 
O 000051 000000 0000 11 000 11 AGAIN LDA 0,1 

PUT NAME IN LINE 0000016 
O #0023 
A 000052 000117 7570 00 010 12 STAQ NAME 00000170 #0024 
U 000054 000000 7570 00 000 14 STAQ TEMP 00000190 #0026 
U 
U 


000056 000000 000116 001 16 ZERO TEMP,CHAR 00000210 #0028 


000114 000000 0001 00 000 23 TAL1 TALLY TEMP+1,1 
OUTPUT TALLY 000002 

80 #0035 

TEMP #0061 


Leave. At this point the assembly 
errors should be corrected and the 
job resubmitted. 


?DONE@--------- 


To place the object program (H*) 
on file PASFIL, a $ EXECUTE card 
would be added to the deck setup 
of the source program. 


BR99 


SECTION IIil 


SCAN SUBSYSTEM 


SCAN FUNCTION 


The SCAN subsystem permits scanning output from the following types of 
batch jobs at a Time-Sharing System terminal: 
@® Those submitted via CARDIN. 


@e Those submitted via remote batch facility of the 
General Remote Terminal Supervisor (GRITS). 


e Those submitted at the central site. 
The output to be scanned must have been saved on a permanent file. 


The output file to be scanned will fall into one or more of the 
following format categories: 

GMAP assembly listing (GMAP) 

FORTRAN compilation listing (FORT) 

COBOL compilation listing (COBOL) 

General Loader output: load map, etc. (LOAD) 

User-generated output (USER) -- that is, not in any standard format 


Special command verbs and other facilities are provided for oP orar ind on 
these forms of output. 


Essentially, the SCAN subsystem allows perusal, by means of highly 
selective listing, of any type of batch output, with special features 
that facilitate efficient inspection of commonly desired items of 
information -- for example, flagged lines in a GMAP assembly. 
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SCAN OPERATION DESCRIPTION 


The SCAN question/answer sequence is as follows: 
Question: SYSTEM? 
Response: SCAN 
Question: FILE? 
Response: filedescr or filedescr;n 
where filedescr is the file description and n is 
number of segments to be scanned in sequence “when 
file is segmented by end-of-file marks. 


Question: FORM? 


Response: One of the following, indicating the format of the fi 


the 
the 


le: 


GMAP - subsystem initially responds with the number of 


assembly errors detected. 


FORT - subsystem initially responds with the number of 


compilation errors detected. 


COBOL - subsystem initially responds with the number of 


compilation errors detected. 


LOAD - subsystem initially responds with the numbe 
errors detected by the loader. 


USER - subsystem initially responds with the ques 
CODE? The user's answer to this question is from on 
five characters to be used by the Subsystem as a 


re OF 


tion, 
e to 
line 


code in searching the user's output text, or the answer 


May be a null response (carriage return only). 
Matching line code in the file is assumed to be 
left-justified in character positions 2-6 of each 
the FIND and PRINT verbs ignore all lines in user f 
output that do not contain the current line code (if 


The 
found 
line; 
ormat 

line 


code is given). The initial line code given may be 


replaced by means of the CODE verb (see the foll 
section). The null response is equivalent to ignore 
codes, if any. 


Line codes can serve to mark lines of the same typ 


owing 
line 


e or 


category in the output text. Use of this feature implies 


that the user has prepared his output with this fe 
in mind. It is not an essential part of the sy 
however; and SCAN may be used with output files 
having line codes. But if the user has control of 
output format, line codes can facilitate the use of 
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A matching mask iS created automatically, so that a 
hierarchy of line codes can be established. For example, 
given lines with El, E2, E1.5 as line codes, a code E 
will find all lines, code El will find lines El and El.5, 
etc. 


Question: EDIT? 


Response: (1) Y or YES - for multiple blank 
suppression. 


(2) N or NO - for printing of multiple 
blanks as is. 


(3) A null response is assumed to be a 
NO response. 


Question: ? 
Response: a SCAN verb 

Note the four level structure in the question/answer sequence: 

1. SYSTEM? 

26 FLUE? 

3. Format (FORM?) 

4. Verbs (?) 
The transition from a lower level to the next higher is made by 
responding to one of these questions with a null line (carriage return 
only). For example, if a user is scanning a file created by a FORTRAN 
compile and execute, he may wish to use the formats FORTRAN and LOAD 
alternately. When he has scanned the FORTRAN listing and wishes’ to 
proceed to the load map, or vice versa, he responds to the initial 


question mark (verb level) with a null line; SCAN then asks for a new 
format (FORM?). 


SCAN VERBS 


The SCAN verbs are given below, with their arguments. Only the first 
four characters are significant; that is, PRINT can be abbreviated as 
PRIN, and BATCH can be extended to BATCHJOB. A blank must separate the 
verb from its argument. 
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First letter abbreviations of the following SCAN verbs are also 
acceptable: PRINT, FIND, SPACE, BACK, ERROR, UNDE, and CODE. 


FIND 


FIND /literal string/;n 


/ represents any desired delimiter chosen by the user. The literal 
string is a pattern of characters to be searched for; n represents 
the nth occurrence. 


The FIND verb positions an implied pointer to the nth line 
containing the literal string (beginning with the line currently 
pointed to). If n is not given, 1 is assumed. If no literal string 
is given, all lines are assumed to match; for example, FIND; 2 is 
equivalent to SPACE 1 (see SPACE verb). 


The FIND verb also accepts all standard Text Editor argument forms. 
PRINT 


PRINT n 
n is the number of lines to be printed. 
PRINT causes a printout at the terminal of the next n_ lines, 


beginning with the current value of the pointer. If n- is not 
specified, only one line will be listed. Lines will be listed along 


with their automatically generated line numbers for future 
reference in LINE verb commands. Line codes are effective, if in 
force. 


Note that the PRINT verb does not move the pointer, so that a 
subsequent FIND verb will begin its search with the first line that 
was listed. 


If n consists of the literal ALL, all lines with a matching code 
will be printed, from the current line to end-of-file. 


The appearance of only a number in the listing of a line indicates 
that the corresponding record is a slew record. 


The PRINT verb also accepts all standard Text Editor argument 
forms. 


LIST 


List n 


LIST is synonymous with PRINT in all respects. 
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SPACE 


The system asks STATION CODE? The user replies ab or simply a 
carriage return, where ab is the station code of a remote-batch 
terminal. 


The system then asks, $ IDENT?, to which the user replies with the 
variable field of his »atch $ IDENT card. 


The BATCH verb initiates a Bulk Media Conversion (BMC) job which 
will transfer the entire contents of the file to remote printer ab. 
If the station-code reply is null, the output will be printed at 
the central site. 


SPACE n 


BACK 


BACK 


LINE 


LINE 


Spaces the pointer ahead n lines. If n is not specified, the 
pointer will advance one line. An attempt to position the file 
beyond its end will result in the file being positioned at its 
beginning, with a warning message to the terminal (EOF). The SPACE 
verb operates independently of line codes. 


n 


Spaces the pointer back n lines. If n is not given, the file will 
be rewound (pointer moved to line 1). The BACK verb operates 
independently of line codes. 


n 


As each line is listed, an automatically generated line number will 
be typed with it. The LINE verb repositions the pointer to the 
specified line number, n. (The line number used need not have been 
printed prior to being referred to.) Line codes are not effective. 
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The above are general purpose verbs. The following special verbs are 
useful for manipulating specific formats: 


ERROR 

ERROR n 
Requests a list of the next n error printouts of the form 
corresponding to the output format in question. (For example, if 
the format is GMAP, flagged instructions. If USER, .FXEM messages 


will be listed.) The absence of n implies all such messages. 


UNDEFINED 


UNDE 


FLAG 


FLAG 


LOAD 


LOAD 


CODE 


CODE 


This command (no argument) is used while scanning GMAP assemblies 
to list all undefined symbols. 


x 


Lists all lines of a GMAP assembly having the error flag specified 
by x (A, U, M, O, etc.). The absence of a Specific error tag 
implies that the user wishes a list of all flagged instructions. 


MAP 


Prints out an abbreviated load map. Only primary SYMDEFs’ are 
listed, and library routines are omitted. 


abcde 


Employed with the user format to change the line code. The argument 
abcde is a one- to five-character code from the Series 600/6000 BCD 
character set. A null argument turns off line codes. That is, all 
line codes are accepted until the CODE verb is used to resume with 
a valid line code. 
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EDIT 


Returns the subsystem to EDIT? 


DONE 


Returns the subsystem to SYSTEM? 


BYE 

Terminates user's current session with the Time-Sharing System. 
REM 
REM text 


Produces the text as remarks line on printer log; otherwise ignored 
by SCAN. 
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SECTION IV 


FDUMP SUBSYSTEM 


FDUMP FUNCTION 


The FDUMP subsystem (file dump and correction) is a remote terminal file 
inspection and maintenance facility for permanent files in the GCOS file 
system. These files reside on a shared-file type of device such as a 
disk storage unit. The files may be generated in either batch, 
remote/batch, or time-sharing environments. 


With the FDUMP subsystem, the user at a remote terminal can manipulate 
the content of any permanent file (to which he has access) as follows: 
e Read into core storage any given 320-word block of the file. 


e Scan the block content, by dumping all or nonzero portions of 
the block at his terminal, using the snapshot function. 


@® Patch selected locations in the block, using the patch function. 

e Rewrite the corrected block back onto the file. 

@e Copy the file. 
This facility is provided primarily for those situations where the user 
needs or wishes to inspect the actual binary content of a file. It is, 
therefore, mainly a debugging tool. The file is dumped and patches are 


specified in octal form. Word locations within a block are also 
specified in octal, beginning with zero. 


FDUMP OPERATIONAL DESCRIPTION 


The user selects FDUMP in response to the subsystem selection question 
SYSTEM? or as a command under the CARDIN subsystem. 


The first-level question asked after the subsystem is called is: 


FILE NAME? 
The permissible responses are: 


carriage return - return to the SYSTEM? level. 
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filedescr - Specified file is accessed, if possible, and treated as 


a linked or random file, depending on how it is 
defined. | 


filedescr;L ~ Specified file is accessed, if possible, and treated 
as a linked file. 


filedescr;R - Specified file is accessed, if possible, and treated 
as a random file. 


Caution: filedescr must not be the same name as another even if the 


uplicate filedescr is in another catalog when the FUNCTION is 
copy (C). 


The second-level question is: 


BLOCK TO BE READ - 


The permissible responses are: 
carriage return - return to the FILE NAME? level. 


n - the block specified by the block serial number n 

~ will be read into an internal buffer. The Copy 
function (see following function description) 
requires a dummy response of l. 7 


If the block serial number is outside the limits of the file, the 
error message BSN OUTSIDE FILE LIMITS is given, and BLOCK TO BE 
READ will be repeated. If the block serial number is within the 
current file size but the implied block was not written on the 
file, it will be read but will contain garbage data not pertaining 
to that file. 


The third level (and final) question is: 


FUNCTION? - (this question is repeated upon return from any of the 
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FDUMP functions.) 
The permissible responses are: 


carriage return - return to BLOCK TO BE READ. 
Sloc - Snap the specified (octal) location. 


Sloc-loc - Snap the field specified by (octal) 
location-location (from-to). 


Sloc,n - Snap n words starting with the specified (octal) location. 


Ploc data - Patch the specified (octal) location with the specified 
Yfoctal) data. 


W - Write the corrected block back into the permanent file. 


4-2 BR99B 


1Q 


filedescr - Copy the complete file onto another file specified by 
filedescr. (Refer to FDUMP Copy Function Details 
paragraph.) 


{oO 


- Done. Return to SYSTEM? or to CARDIN. 


FDUMP Error Indication and Replies 


1. When the named file cannot be accessed, FDUMP replies 
CANNOT ACCESS FILE filename 
and returns control to the calling level (SYSTEM? or CARDIN). 
2. When the block serial number given is either zero or is a 
number larger than the possible number of blocks in the file, 
the error mesSage is: 


BSN OUTSIDE FILE LIMITS 


BLOCK TO BE READ is then repeated. 


For linked files, block size is assumed to be 320 words; the 
first block serial number is 1. Random files are positioned by 
multiples of 40 words DSU200 or 64 words (MDS200 drum and mass 
~~ storage devices), beginning with block 0. However, they are 
| read in blocks of 320. Therefore, one read makes available 
eight contiguous blocks of 40 words or five contiguous’ blocks 
of 64 words. 


3. When the system receives a bad hardware status, FDUMP replies: 
51 FILE filename -- I/O STATUS xx 
FUNCTION? 
A partial block may have been Read and may be correctable by 
use of the S, P, and W functions. If none of the block appears 
to have been Read, answer with a carriage return to repeat the 
BLOCK TO BE READ question. Also, verify the block serial number 


that was specified. 


4. When parameters are incorrect in form for the S, P, or W 
functions, FDUMP will reply 


INVALID INPUT-RETYPE 
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FDUMP Copy Function Details 


The copy is a physical copy; that is, it does not stop at logical 
end-of-file but continues to the file length defined in the file system 
as current size. 


If the copy file is smaller than the size defined for the file to be 
copied, FDUMP grows the copy file to the necessary size. 


Note that filedescr, specifying the copy file, may be simply a file name 


or may be a catalog/file string, but must not have the same filename 


even if duplicate filename is under a separate catalog. 


At completion of the copy, the user will be returned to the FILE NAME? 
level. 
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SECTION V 


CONVERSATIONAL DEBUG 


RBUG GENERAL DESCRIPTION 


The Conversational Debug Routine (RBUG) is a dynamic debugging tool for 
batch programs initiated through the CARDIN subsystem. The user of RBUG 
should be familiar with the normal DEBUG routine and its associated 
control cards as described in the General Loader reference manual. 


When the control card $ USE RBUG are used, the normal DEBUG routines are 
superseded by RBUG; control and information are then obtained in exactly 
the same manner as in the standard routine. By the use of the BREAKPOINT 
pseudo-variable on the General Loader DEBUG control card, the user may 
gain control at specified points in his program. At those points, the 
user may: 


1. Obtain snapshots of locations and registers. 
2. Replace the contents of locations and registers. 


3. Insert further breakpoint locations or delete breakpoints he 
has placed earlier (breakpoints specified in the control card 
or FORTRAN statement may not be deleted). 


4, Continue the run at the interrupt point or another point; or 
. stop the run, either by normal termination or abort. 


Because of the way the loader builds DEBUG tables, variables are printed 
for each debug location in reverse order. Therefore, if a breakpoint is 
desired, the BREAKPOINT pseudo-variable should be the first in the list, 
so that a typeout of the requested variables occur before the breakpoint 
is executed. When a point is reached in the execution of the program for 
which conditions specified by the control card or DEBUG statement are 
met, output (if any) is typed at the user's terminal. In addition, if 
there has been a breakpoint specified, execution of the program is 
suspended and a question mark printed, asking for instructions. After 
each instruction has been acted upon, a question mark is typed, 
requesting further instructions until the user asks to run, terminate, 
or abort. 
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RBUG instructions, listed in the following section, are all composed of 
a Single letter command followed in most cases by an argument. The 
argument follows the standard DEBUG convention that all variables are 
considered to be single dimension arrays, with the first element being 
element number 1. Therefore the general form of an argument is: 


Name (i, j, k) 


where the subscripts have the meanings from, to, and increments of. For 
example A(3,9,2) has the meaning from A(3) to A(9) in steps of 2 -- that 
1s, A(3), A(5), A(7), A(9). 


The name is that of a variable within the subroutine at which the 
program was interrupted or of a variable in common. If the name contains 
Only numerics between 0-7, it is considered an octal location. Therefore 
9(3) would be interpreted as the location of statement 9 plus 2, but 
7(9) would be interpreted as octal location 17 (7 plus 8 = decimal 15 = 
octal 17). In order to enable reference to FORTRAN statements not 
containing an 8 or 9, the pound sign (#) is treated as an invisible 
alphabetic. For example, statement 23 can be referred to as #23, 234° OF 
2#3. 


Subscripts, where applicable,-are optional. 


RBUG INSTRUCTIONS 
The following RBUG instructions are available to the user: 


A (ASCII) prints out in ASCII format the contents of the 
requested locations. 


B (Breakpoint) inserts a dynamic breakpoint at the desired 
location. When this point in the program is later reached, 
the user is notified, and has then the same instruction 
capability as he would have at a normal breakpoint. 
However, 1f the breakpoint location is specified octally, 
no symbol table is available; and therefore at this 
breakpoint only octal addresses may be used. 


C (Complex) prints out the contents of pairs of cells in 
complex format. Subscripts refer to pairs, not to 
individual locations. 


D (Double precision) prints out a double precision, floating 
point representation of the word pairs referenced. 
Subscripts refer to word pairs, as above. 
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(Erase breakpoint) eliminates a previously inserted dynamic 
breakpoint. 


(Floating) prints out a floating point representation of 
the locations referenced. 


(Hollerith) prints out a Hollerith (BCI) representation of 
the locations referenced. 


(Integer) prints out a decimal representation of the 
locations referenced. 


(Logical) prints out a logical representation (T or F) of 
the locations referenced. 


(Modify) is used tc change the contents of a register. The 
form of the instruction is Mr xxxx, where r represents’ the 
register to be modified, and XXXX is an octal 
representation of the new contents - right-justified and 
zero filled in the register. The permissible values of r 
are A, Q, E, I, or XO through X7. 


(Octal) prints out the contents of the referenced locations 
in octal notation. 


(Patch) replaces the contents of the given location with a 
new value. General form of the instruction is Pname(i) 
XXXXXXX. The value oO ae is right-justified and 
zero-filled. 


(Quit) - no argument. Causes the program being monitored to 
abort with reason code Xl. 


(Run) causes the program to resume at the instruction which 
was replaced with the breakpoint. If an argument is given 
(single location), the program is given control at that 
point. 


(Starting address) is a single argument instruction. The 
location given as the argument is added to all subsequent 
locations given in octal. For example, having given SABC as 
an instruction, 023 prints out (in octal) cell 23(8) 
relative to location ABC. Locations specified symbolically 
are not affected by the starting address. The address may 
be changed at will by the user and may be nullified by a 
simple S (equivalent to SO, start at zero). 
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T (Terminate) causes the program to terminate normally, by 
calling .FEXIT. 


W (Where) is used with a single argument. It prints out in 
octal the effective address of that argument. 


X (Display registers) is used without argument. It yields a 
panel dump of all registers. It may also be used 
selectively with the following forms: XA, XQ, XE, XI, or XO 
through X7. 


The user establishes direct access connection with his program either by 
the TALK option of CARDIN or by logging off from time-sharing and 
calling a GRITS phone number. He then requests to be connected with his 
SNUMB. For example, when submitting from CARDIN, the user is notified 
that he has been assigned SNUMB #0042T. He then answers BYE to the 
system question, calls GRITS, and requests $*S$DAC0042T. 


Appendix A contains a sample program in which use of RBUG is 
illustrated. 
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SECTION VI 


CONVERSATIONAL FILE AND RECORD INPUT/OUTPUT 


The File and Record Control routines include a conversational, or direct 
access, input/output capability, using the File and Record Control OPEN, 
GET, PUT, and CLOSE calls, and a direct access file control card, $ DAC. 
The $ DAC control card allows the user to specify one or more of his 
program files as conversational, to be connected directly to a remote 
terminal device. 


An additional control card, $ USE .RTYP, must be used in order to 
activate the required File and Record Control routines (.GOPNR, .GCLSR, 
.~GGETR, .GPUTR). 


Appendix A contains a sample program in which use of File and Record 
Control conversational routines are illustrated. 


CONTROL CARDS FOR FILE AND RECORD CONTROL I/O 
e $s DAC 
The Direct Access (DAC) file control card has the following format: 
S$ DAC fc (,qd) 


Where: fc - A two-character alphanumeric file code identifying 
a direct access file referred to in the program (or 
FCB). 


ad - An optional one-character logical unit designator. 
If the ,d field is omitted, blank is assumed. 


The logical unit designator is provided primarily for future system 
implementations. This field normally is omitted; if the associated 
terminal device is to be connected via the TALK option in CARDIN -- 
the standard case -- this field must be omitted (or d must be 
blank). 
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S USE .RTYP 


The $ USE .RTYP control card must appear in the job control deck to 
direct loading of the correct File and Record Control routines. If 
this card does not appear, any reference to a file defined as 
direct access causes a program abort with a code of NT. 


APPLICABLE I/O CALLS 


The following File and Record Control calls are applicable to a direct 
access, or conversational, file: 


OPEN -- Connect a remote terminal device and open file. 

GET -- Read logical record from a remote terminal. 

PUT -- Write logical record to a remote terminal. 

CLOSE -- Close file and Disconnect a remote terminal device. 


The calling sequences are standard, as described in the File and Record 
Control reference manual. The usage of the calls is also standard except 
as noted in the following functional descriptions. 


OPEN 


This function attempts to connect a remote terminal device 
identifying itself by snumbd, where snumb is the sequence number of 
the calling program (job), and d is the logical unit designator 
(normally blank). If no such terminal requests a direct access 
connection within a reasonable time (on the order of several 
minutes), the FCB is marked file-not-present; and control is 
returned to the program. If a connection is made, the station code 
(line ID) of the terminal is placed in LOCSYM -4 (upper); and the 
file is marked present and open. 


GET 


The terminal is sent the input-request message: 
ic? 


where fc is the current file code. 
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When input is received from the terminal, it is translated to BCD 
and stored as a standard system record in the user's buffer. If the 
record type is fixed, short input lines are blank filled to 
correspond to the record size specified in the FCB. Variable length 
records are blank filled to a minimum of 14 words. 


A null input line (carriage return only) results in an end-of-file 
return, aS will also a break or disconnect. On an end-of-file 
return, the user may determine the reason from the first status 
return word (LOCSYM -3, bits 6-11); the code is: 


0 = null line 
l = break signal 
2 = terminal disconnect 


The carriage return null input does not set the end-of-file bit, 
thus communication with the terminal may continue. 


@e PUT 


The output in the user's buffer is translated from BCI to ASCII and 
sent to the terminal. The use of this call carries the same 
restriction as is imposed on the WTREC call -- data must be present 
prior to the call. (This restriction does not normally apply to PUT 
for nonconversational files, where it can be used to reserve buffer 
Space without moving data.) 


A break signal or a disconnect during the call will cause the 
end-of-file status to be posted in the FCB, with status code 1 or 
2. (See GET, above.) (End-of-file during a PUT on nonconversational 
files normally causes an abort.) 


@e CLOSE 


The connected terminal is notified that the file is being closed, 
and the corresponding file is marked closed. 


SPECIAL FILE AND RECORD CONTROL I/O CONSIDERATIONS 


All required ASCII-to-BCD and BCD-to-ASCII translations are performed by 
the GET and PUT subroutines. The user's output buffer must therefore 
contain BCD data; his input buffer will contain BCD data following the 
GET call. 
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During a PUT call, a break or attention Signal (normal means of 
interrupt from a terminal) or a user-initiated disconnect results simply 
in the posting of an end-of-file status in the FCB, rather than a 
program abort. It is the user's responsibility to check periodically for 
Such occurrences (code 1 or 2 in LOCSYM -3, bits 6-11). 


The optional logical unit designator in the $ DAC control card allows 
multiple terminals to be connected Simultaneously to one program (one 
terminal device per. file). The terminals requesting connection are 
distinguished by Snumbd; , snumbd9,..., snumbdn. A terminal connected 
via the TALK option of CARDIN implicitly carries a logical unit 
designator of blank (040 octal); the corresponding $ DAC control card 4d 
field must be null. Any terminals to be connected to nonblank designated 
program files must be connected through the normal GRTS procedure: (1) 
dialing up a GRITS line and (2) a direct access connection request, S$*S 
DAC snumbd. 


One terminal aevice may be connected to more than one program file 
(though the converse is not true). In this case the several S$ DAC file 
cards specify or imply the same logical unit designator (normally 
blank). 
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SECTION VIL 


JOUT SUBSYSTEM 


JOUT FUNCTION 


The JOUT subsystem permits manipulating output from the following types 
of batch jobs at a time-sharing terminal: 


e Those submitted via CARDIN with a DISPOSITION response (after a 
RUN command) that includes J or JOUT. 
e Those submitted via GRTS remote batch. 


e Those submitted at the central site. 


The output to be manipulated must be designated for a remote destination 
and must contain a $ USERID control card. 


The output file to be scanned will fall into one or more of the 
following format categories: 

GMAP assembly listinc (GMAP) 

FORTRAN compilation listing (FORT) 

COBOL compilation listing (COBOL) 

Core dump (DUMP) 

General Loader output: load map, etc. (LOAD) 


User-generated output -- that is, not in any standard format 
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JOUT OPERATIONAL DESCRIPTION 


The JOUT question/answer sequence is as follows: 


QUESTION: SYSTEM? 


Response: JOUT or JOUT sssss 


Where: sssss - SNUMB for the job whose output is to be 
manipulated. If only JOUT is entered, the system 
requests SNUMB? 


A null response causes a return to SYSTEM? 


If the job output is not available for 
manipulation, the system transmits one of the 
following messages to the terminal and returns to 
the SYSTEM? level (sssss is the job SNUMB): 


sssss OUTPUT IS BUSY 
The job was found but is being printed at the central site, at 
a remote batch station, or at another time-sharing terminal. 


sssss OUTPUT NOT FOUND 
The desired job was not found in the system. 


sssss NOT YOUR JOB 
The log-on USERID does not match the USERID found in the job 
stream. 


BATCH SYSTEM FULL--TRY LATER 
Time-sharing cannot communicate with SYSOUT at this time, or 
not enough room exists to read the file. 


SSSSS READING-CR 
The job is being input through the central site card reader. 


SSSSS READING-MT 
The job is being read from magnetic tape. 


SSSSS READING=-RMT 
The job is being read from a remote station. 


sssss WAITING-ALLOC 
The job is not yet a candidate for peripheral allocation. 


sssss WAIT-PERIF 
The job is waiting for peripheral allocation. 


sssss WAIT-CORE 
The job is waiting for core allocation. 


sssss IN HOLD 
The central site operator has placed a hold on this job. 
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sssss IN LIMBO . 
The job is waiting for a RUN command from the central site 
operator. 


sssss EXECUTING 
The job is in execution. 


sssss WAIT-TAPE 
The job is waiting for the operator to mount or ready a 
specified tape. 

sssss TOO BIG 
This job's requirements exceed the sieve limits set by the 
central site. 


sssss OVERDUE 
The allocation of this job is overdue. 


sssss IN RESTART 
The job is waiting to be restarted by the operator after a 
system failure. 


sssss TERMINATING 
This job is engaged in the termination procedure. 


! . ) 
Quen fron SHUM LB é 
QUESTION: FUNCTION? 


Response: One of the following commands. When the function has been 
completed, the system returns to FUNCTION? 


e ACTIVITY 
ACTIVITY n nz of 


JOUT prepares to read the activity specified by n. 


@ DIRECT 
a. DIRECT id 


Direct the output to the remote station specified by id. 


b. DIRECT ONL 


Print the output at the central site. 
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EPRINT re 

Simulate printer report output. The report code rc may be any of 
the codes received from the LIST command, or §$ may be 
substituted for a report code. The $$ causes the printing of the 


J* file (control card list and execution report) at the 
terminal. Trailing blanks and blank lines are suppressed. 


e LIST 
LIST 


List the report codes associated with the current activity. 


@ PRINT 
PRINT re 
Simulate printer report output. The report code rc may be any of 
the codes received from the LIST command, or $$ may be 
substituted for a report code. $$ causes the printing of the J* 
file (control card list and execution report) at the terminal. 
Multiple blanks are suppressed by the PRINT command. 

@ REMOVE 
REMOVE 


Remove the output from the system. 


e@ SCAN 
SCAN re 
Scan. the job output with report code rc. The system requests 
FORM? From this point, the question/answer sequence and the 


facilities available are the same as for the SCAN subsystem (see 
Section III), with the exceptions noted below: 


1. The following SCAN verbs are not available: BATCH, REM, REM 
text, and BYE. 


2. Output in core dump format may be scanned. (Answer DUMP to 
the FORM? question. There is no initial subsystem response 
to this answer; the EDIT? question appears immediately.) 


3. DONE returns the user to the FUNCTION level. 
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APPENDIX A 


INTERFACE USAGE EXAMPLES 


The following sample program illustrates the use of interrelated 
time-sharing subsystems and batch programming features. The program is 
Submitted by means of the time-sharing CARDIN' subsystem. Direct 
conversation between the program and the user's terminal is’ then 
initiated, and use is made of two conversational batch dimension 
features--Conversational Debug Routine (RBUG) and conversational I/0 
extensions to File and Record Control. Text within brackets is not part 
of the program but has been added to illustrate particular features. 


[The program, submitted under CARDIN, makes use of conversational I/0 
extensions to File and Record Control. The STAB option on the S$ FORTRAN 
card is not a requirement initially but is required for use with the 
subsequent RBUG portion of the program. ] 


0100$; IDENT; VXEOO , JDOE ' 
0200$ ;OPTION; FORTRAN 


201$;USE;.RTYP Required when DAC cards are 
0300S ; FORTRAN ;NDECK,STAB present. 


400#2;WRITE (6,3) 

0500#3 ;FORMAT (27HPROGRAM TO CALCULATE RECOIL) 
O600#1;WRITE (6,4) 
0700#4;FORMAT (9HRIFLE WT.) 
0800;READ(5,5)WR 
0900#5;FORMAT (F6.2) 
1000;WRITE (6,7) 

1100#7;FORMAT (LOHBULLET WT.) 
1200; READ (5,5) WB 

1300#9;WRITE (6,10) 
1400#10 ; FORMAT (8HVELOCITY) 
1500#11;READ(5,5)VB 

1600 ;WRITE (6,13) 
1700#13;FORMAT (LOHPOWDER WT.) 
1800;READ (5,5) WP 

1900; X=WB*VB+4700 .*WP 
2000;Y=7000.*WR 

2100; Z=WR/64.4 

2200 ;E=Z* (X/Y) **2 
2300#15;WRITE(6,16)E 
2400#16;FORMAT (8HENERGY= F6.2,9H FI. LBS.) 
2500;GO TO 1 

2600 ;END 

2700$;EXECUTE 

2800$;DAC;05 

2900$;DAC;06 

3000S ;ENDJOB 


READY 
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[ The program is then formatted for legibility. | 


*PRINT 
CARD FORMAT ? 

NORM (;) 

09/10/69 09.69 

0100 S IDENT VXE00 , JDOE 
0200 S OPTION FORTRAN 

201 S USE .RTYP 

0300 S FORTRAN NDECK,STAB 
400 2 WRITE (6,3) 

0500 3 FORMAT (27HPROGRAM TO CALCULATE RECOIL) 
0600 1 WRITE (6,4) 

0700 4 FORMAT (9HRIFLE WT.) 
0800 READ (5,5)WR 

0900 5 FORMAT (F6.2) 

1000 WRITE (6,7) 

1100 7 FORMAT (LOHBULLET WT.) 
1200 READ (5,5) WB 


1300 9 WRITE (6,10) 
1400 10 FORMAT (8HVELOCITY) 
1500 11 READ (5,5) VB 


1600 WRITE (6,13) 

1700 13 FORMAT (LOHPOWDER WT.) 
1800 READ (5,5) WP 

1900 X=WB* VB+4700.*WP 
2000 Y=7000.*WR 

2100 Z=WR/64.4 

2200 E=Z* (X/Y) **2 


2300 15 WRITE (6,16)E 
2400 16 FORMAT (8HENERGY= F6.2,9H FT. LBS.) 


2500 GO TO l 
2600 END 

2700 $ EXECUTE 
2800 $ DAC 05 
2900 $ DAC 06 
3000 S$ ENDJOB 
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[The program is then passed to the batch_system for processing; the TALK 
option permits direct-access connection. ] 


*RUN 
SNUMB # 0165T 

CARD FORMAT, DISPOSITION ? 

NORM (;) , TALK 

PROGRAM TO CALCULATE RECOIL 

RIFLE WT. 

0528.5 

BULLET WT. 

05?150 

VELOCITY 

0523200 

POWDER WT. 

05258 

ENERGY=320.06 FT. LBS. 

RIFLE WT. 


05? Carriage return; null response.]| 
KKK KKK KK KK KERRRRRRERR RE RER RRR RRR RE RERRRR RRR EERE EKRKKKKERKE 


KKK KKK KKK KER KKK RR ERERE KERR KEKE KERR ERERKEEKERERROR 
TRACE OF CALLS IN REVERSE ORDER 


CALLING ID ABSOLUTE ARGUMENT ARGUMENT 
ARGUMENT ARGUMENT ARGUMENT 
ROUTINE # LOCATION #1 #2 
# 3 # 4 #5 
. FEOF. 19 035114 000000000042 
ERROR 
»~FRDD. 954 036771 
ERROR 
cece. 5 037556 000000000005 352606330255 
ERROR 
END OF FILE READING FILE CODE 05 OPTIO 


OPTIONAL RETURN NOT REQUESTEDO13068 
KK KR RK KKK KK RR KR KKK RRR RRR KKK KKK KR KR RRR RRR KER EE KR KEK KEKE KEKE KKK 


KKKEKKKKEKKEKRKEKKKEKKRKEKE KEK ER KEKE KEEKEKKEKKEKKKKERKRERROR 


CLOSING FILE 05 
CLOSING FILE 06 


ACTIVITY TERMINATED 
NORMAL TERMINATION 
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[a S$ USE RBUG card is substituted for S USE .RTYP to initiate the RBUG 


subroutine, and breakpoints are inserted. The program is then 


in its new version.] 


*201S;USE;RBUG 

*202S;DUMP;...... 
*203;DEBUG; 2/ (BREAKPOINT) 
*204;DEBUG;15/ (BREAKPOINT) 


*PRINT 


CARD FORMAT ? 


NORM (; ) 
09/10/69 


0100 
0200 
201 
202 
203 
204 
0300 $ 
400 2 
0500 3 

1 

4 


HMM” 


0600 
0700 
0800 
0900 5 
1000 

1100 7 
1200 

1300 9 
1400 10 
1500 Ll 
1600 

1700 1.2 
1800 

1900 

2000 

2100 

2200 

2300 15 
2400 16 
2500 
2600 
2700 
2800 
2900 
3000 


Ur Tn 


09.85 

IDENT  VXE0O0,JDOE 
OPTION FORTRAN 

USE RBUG 

DUMP Besant 

DEBUG 2/(BREAKPOINT) 
DEBUG 15/(BREAKPOINT) 
FORTRAN NDECK,STAB 
WRITE (6,3) 

FORMAT (27HPROGRAM TO CALCULATE RECOIL) 
WRITE (6,4) 


FORMAT (9HRIFLE WT.) 
READ (5,5)WR 
FORMAT (F6.2) 


WRITE (6, 


7) 


FORMAT (1OHBULLET WT.) 
READ (5,5) WB 


WRITE (6, 


10) 


FORMAT (8HVELOCITY) 
READ (5,5) VB 


WRITE (6, 


13) 


FORMAT (LOHPOWDER WT.) 
READ (5,5) WP 


X=WB* VB+4700.*WP 


Y=7000.*WR 


Z=WR/64. 


4 


E=Z* (X/Y) **2 


WRITE (6, 
FORMAT (8HENERGY= 


GO TO l 
END 
EXECUTE 
DAC 
DAC 
ENDJOB 


16)E 


05 
06 


F6.2,9H FT. LBS.) 


formatted 
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[The program is again passed to the batch system, along with the TALK 
option. Control of the program is obtained at breakpoints, 
interrogations are made, and the program is then permitted to continue 
and run to termination. ] 


* RUN 

SNUMB #0166T 
CARD FORMAT, DISPOSITION ? 
NORM (;) , TALK 


***ROUTINE 4.222. LOC 2 COUNT oo00001 
222R 

PROGRAM TO CALCULATE RECOIL 

RIFLE WT. 

0528.5 

BULLET WT. 

05?150 

VELOCITY 

05?3200 

POWDER WT. 

05258 

**k*ROUTINE ...--- LOC 15 COUNT 000001 
???FWR CHECK ANSWER 

WR 0.85000000E Ol 


???FE I CHECKED THE WRONG THING 
E 0.38320059E 05 

2??2?FWB CHECK BULLET WEIGHT 

WB O.1L5000000E 04 

???R#2 BULLET WEIGHT FUNNY, TRY AGAIN WITH DECIMAL POINTS 
*XKXROUTINE 2.2222. LOC 2 COUNT 000002 
22??R BEGIN NORMAL RUN 

PROGRAM TO CALCULATE RECOIL 

RIFLE WT. 

0528.5 8 AND 1/2 POUNDS 

BULLET WT. 

05?150.0 150 GRAINS 

VELOCITY 

05?3200.0 FEET PER SECOND 

POWDER WT. 

05?58.0 GRAINS 

*XKROUTINE ..ecee LOC 15 COUNT 000002 
2???FE GET A PEEK AT ANSWER 

E 

???R LOOKS GOOD 

ENERGY= 21.11 FT. LBS. 

RIFLE WT. 

05?7.5 

BULLET WT. 

05?150. 

VELOCITY 

0522175 

POWDER WT. 

05?31.0 I MADE A MISTAKE. NO DECIMAL ON VELOCITY 
Ree ROUTINE: -aesheen- “LOC? 15 COUNT 000003 
2???R#2 TRY AGAIN. THIS TIME WITH DECIMAL POINT. 
SESROUTINE weeee%e: <LOC-2 COUNT 000003 
2??R 

PROGRAM TO CALCULATE RECOIL 
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RIFLE WT. 

05?7.5 

BULLET WT. 

05?150. 

VELOCITY 

0522175 

POWDER WT. 

05?0. AGAIN FORGOT THE DECIMAL POINT 
*S*ROUTINE oes<es LOC 25 COUNT 
???R#2 TRY AGAIN 

***kROUTINE ...-2-2- LOC 2 COUNT 
fatare TRY A "NORMAL" RUN 

PROGRAM TO CALCULATE RECOIL 

RIFLE WT. 

0577.5 

BULLET WT. 

05?150.0 

VELOCITY 

052?2175.0 

POWDER WT. 

052?31.0 

*ESROULINE «evaeee: IOC 15 COUNT 
cecre PEEK AT ANSWER 

E 0.94112817E O01 


???R ANSWER SEEMS ABOUT RIGHT FOR 30/30 WITH LIGHT LOAD 


ENERGY= 9.41 FT. LBS. 
RIFLE WT. 
0527.5 TRY 30.06 TYPICAL LOAD 
BULLET WT. 
05?180.0 
VELOCITY 
05?2505.0 
POWDER WT. 
05?45.0 
***ROUTINE ..266-e LOC 15 COUNT 
oo eR LET IT GO NORMALLY 
ENERGY= 18.54 FT. LBS. 
RIFLE WT. 
05?0. 
BULLET WT. 
0570. 
POWDER WT. 
0570. 
DIV CHECK AT LOCATION 037651 
EXP OVERFLO AT LOCATION 037400 
**XROUTINE ..222-. LOC 15 COUNT 
222?T LET THE PROGRAM QUIT NORMALLY 
Te EK ET 
CLOSING FILE 05 
CLOSING FILE 06 


ACTIVITY TERMINATED 
NORMAL TERMINATION 


*BYE 


000004 


000004 


000005 


000006 


000007 
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co 


INDEX 


S DAC 
S DAC 
S DAC 


S IDENT 
S IDENT card 


S IDENT? 
S IDENT? 
S$ IDENT? 


S SELECTA 
S SELECTA Card Option 


S USE 
S USE .RTYP 
S USE .RTYP 
S USE RBUG 
S USE RBUG 


S USERID 
S USERID control card 


.RTYP 
S USE .RTYP 
S USE .RTYP 


ABCDEIJ 
abcde (i,j) 


ACTIVITY 
ACTIVITY 


ASCBCD 
ASCBCD 
ASCBCD Question/Answer Sequence 


ASCII=-TO-BCD 
ASCII-to-BCD conversion 


ASIS 
ASIS 
ASIS 


AUTO 
AUTO 

BACK 
BACK 


BATCH 
BATCH 


OV OV 
I 
eH oS 


BR9Q 


“BCDASC 
BCDASC 
BCDASC Question/Answer Sequence 


BLOCK TO BE READ 
BLOCK TO BE READ 


BPRINT 
BPUNCH and BPRINT 
BPUNCH or BPRINT Question/Answer Sequence 


BPUNCH 
BPUNCH and BPRINT 
BPUNCH or BPRINT Question/Answer Sequence 


BREAKPOINT 
breakpoint 


S IDENT card 
S$ SELECTA Card Option 
S USERID control card 


CARD FORMAT 
CARD FORMAT, DISPOSITION? 


CARDIN 
CARDIN Command Language 
CARDIN DETAILED OPERATION 
CARDIN FUNCTION 
CARDIN SUBSYSTEM 
TALK option of CARDIN 


CARDIN OPERATION 
CARDIN OPERATION 


CHARACTER 
standard character 
multiple tab characters 
Tab characters 
tab characters 


CLOSE 
CLOSE 


CODE 
CODE 
Line codes 


COMMAND 
CARDIN Command Language 
Special command verbs 


CONSIDERATIONS 
FILE AND RECORD CONTROL I/O CONSIDERATIONS 
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CONTROL 
S USERID control card 


FILE AND RECORD CONTROL I/O CONSIDERATIONS 


CONTROL CARDS 


CONTROL CARDS FOR FILE AND RECORD CONTROL I/O 


CONVERSATIONAL 
CONVERSATIONAL DEBUG 


CONVERSATIONAL FILE AND RECORD INPUT/OUTPUT 


CONVERSION 
ASCII-to-BCD conversion 


COPY 
copy file 


COPY FUNCTION 
FDUMP Copy Function Details 


DEBUG 
CONVERSATIONAL DEBUG 


DESCRIPTION 
FDUMP OPERATIONAL DESCRIPTION 
JOUT OPERATIONAL DESCRIPTION 
RBUG GENERAL DESCRIPTION 
SCAN OPERATION DESCRIPTION 


DIRECT 
DIRECT 


DISPOSITION? 
CARD FORMAT, DISPOSITION? 
DISPOSITION? 


DONE 
DONE 


DUMP 
file dump 
EDIT 


EDIT 


EDIT? 
EDIT? 


EPRINT 
EPRINT 


ERROR 
ERROR 
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F DUMP 
FDUMP 
FDUMP Copy Function Details 
FDUMP Error Indication and Replies 
FDUMP FUNCTION 
FDUMP OPERATIONAL DESCRIPTION 
FDUMP SUBSYSTEM 


FILE 
CONVERSATIONAL FILE AND RECORD INPUT/OUTPUT 
copy file 
FILE AND RECORD CONTROL I/O CONSIDERATIONS 
FILE NAME; TYPE 
file dump 


FILE AND RECORD CONTROL 
File and Record Control routines 


FILE AND RECORD CONTROL I/O 
CONTROL CARDS FOR FILE AND RECORD CONTROL I/O 


FILE-BUILDING 
file-building 


FILES 
permanent files 


FIND 
FIND 


FIRST 
First Line Reformatting Information 


FLAG 
FLAG 


FORM? 
FORM? 


FUNCTION? 
FUNCTION? 


GET 
GET 
GET 


I/O 
FILE AND RECORD CONTROL I/O CONSIDERATIONS 
I/O CALLS 


INPUT/OUTPUT 
CONVERSATIONAL FILE AND RECORD INPUT/OUTPUT 


INSTRUCTIONS 
RBUG INSTRUCTIONS 


INTERFACE 
INTERFACE USAGE EXAMPLES 
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fs 


JABT 
JABT 


JDAC 
JDAC 


JOUT 
JOUT 
JOUT 
JOUT FUNCTION 
JOUT OPERATIONAL DESCRIPTION 
JOUT SUBSYSTEM 


JSTS 
JSTS 


LABELS? 
LABELS ? 
LABELS ? 


LANGUAGE 
CARDIN Command Language 


LINE 
First Line Reformatting Information 
LINE 
Line codes 
line numbers 
LINE NUMBERS? 


LIST 
LIST 
LIST 


LITERAL 
literal string 


LOAD 
LOAD MAP 


MOVE 
MOVE 
MOVE 
MOVE 


NAME; TYPE 
FILE NAME; TYPE 


NORM 
NORM 
NORM 


OPEN 
OPEN 
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OPE RATIONAL 
FDUMP OPERATIONAL DESCRIPTION 
JOUT OPERATIONAL DESCRIPTION 


PERMANENT 
permanent files 


PRINT 
PRINT 
PRINT 
PRINT 
RUN or PRINT Question/Answer Sequence 


PUT 
PUT 


QUESTION /ANSWER 
-ASCBCD Question/Answer Sequence 
BCDASC Question/Answer Sequence 
BPUNCH or BPRINT Question/Answer Sequence 
RUN or PRINT Question/Answer Sequence 


RBUG 
$ USE RBUG 
$ USE RBUG 
RBUG 
RBUG 
RBUG GENERAL DESCRIPTION 
RBUG INSTRUCTIONS 


RECORD 


CONVERSATIONAL FILE AND RECORD INPUT/OUTPUT 
FILE AND RECORD CONTROL I/O CONSIDERATIONS 


REFORMATTING INFORMATION 
First Line Reformatting Information 


REM 
REM 


REMOVE 
REMOVE 


REPLIES 
FDUMP Error Indication and Replies 


ROUTINES 
File and Record Control routines 


RUN 
RUN 
RUN or PRINT Question/Answer Sequence 


yr iar fa 
NO ll eed on on 


NO NO 
1 
“SIS 
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”™ 


SCAN 
SCAN 
SCAN 
SCAN FUNCTION 
SCAN OPERATION DESCRIPTION 
SCAN SUBSYSTEM 
SCAN VERBS 


SETTINGS 
tab settings 
tab settings 


SNAPSHOTS 
snapshots 


SPACE 
SPACE 


STAB 
STAB option 


STANDARD 
standard character 


STATION CODE? 
STATION CODE? 


STRING 
literal string 


STRIP 
STRIP 
STRIP 


SUBSYSTEM 
CARDIN SUBSYSTEM 
FDUMP SUBSYSTEM 
JOUT SUBSYSTEM 
SCAN SUBSYSTEM 


TAB 
multiple tab characters 
Tab characters 
tab characters 
tab settings 
tab settings 


TAB CHARACTERS AND SETTINGS? 
TAB CHARACTERS AND SETTINGS? 
TAB CHARACTERS AND SETTINGS? 
TAB CHARACTERS AND SETTINGS? 


TALK 
TALK 
TALK 
TALK 
TALK option of CARDIN 
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UNDEFINED 
UNDEFINED 


URGCXX 
URGC (xx) 


VERBS 
SCAN VERBS 
Special command verbs 


WAIT 
WAIT 
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